home *** CD-ROM | disk | FTP | other *** search
/ Extreme Heat: Share the Heat (Special Edition) / Extreme Heat - Share the Heat - Special Edition (TCD 5002) (CD Factory).iso / viewer / gifwarp1.zip / GIFWARP.DOC next >
Text File  |  1991-01-03  |  13KB  |  311 lines
  1.  
  2.  
  3.                          G I F W A R P ! 
  4.  
  5.                            Version 1.0
  6.                         November 1, 1990
  7.      
  8.      A Transformation Program for Your GIF(tm) Pictures
  9. Copyright 1990, Steve Enns and Dan Magosse, All right reserved. 
  10.  
  11.      GIFWARP! is produced by:
  12.  
  13.            Steve Enns                     Dan Magosse 
  14.         2425 Haultain Ave.             1321 14th St. East 
  15.           Saskatoon, Sk.                 Saskatoon, Sk. 
  16.           Canada S7J 1R2                 Canada S7H 0A6 
  17.  
  18.      Our motto:
  19.      
  20.      "We endeavour to pursue faithfully the highest principles in
  21.      sophisticated program design and development - until we're
  22.      offered more money or more exciting jobs."
  23.  
  24.      Top Ten Phrases heard around this lab:
  25.  
  26.                "What does `File Allocation Table Bad' mean?"
  27.                "Where was that bottle?"
  28.                "Sure it's weird, but will it sell?"
  29.                "Are these deductions right?"
  30.                "Where's that Stones tape?"
  31.                "Yah, C is okay, but can you do it in FORTRAN?"
  32.                "Where was that bottle?"
  33.                "I thought YOU fed the sled dogs!"
  34.                "Error handling?  What's that?"
  35.                "Where was that bottle?"
  36.  
  37.      Okay, here's the boring stuff, but don't worry, it's better
  38.      than chewing tinfoil:
  39.  
  40. ACKNOWLEDGEMENTS
  41.  
  42.      Kudos, thanks, and good karma to John Bridges for the
  43.      enlightening information and code contained in his VGAKIT
  44.      package.  Trademarks like GIF(tm) and PC(tm) are held by
  45.      their respective companies. 
  46.  
  47. DISCLAIMER
  48.  
  49.      The GIFWARP! program is provided without warranty of any
  50.      kind.  The user of the GIFWARP! assumes complete
  51.      responsibility for any and all incidental or consequential
  52.      damages which may occur during normal or abnormal use of the
  53.      GIFWARP! program.  Use the GIFWARP! program at your own
  54.      risk.
  55.  
  56. LICENSE 
  57.  
  58.      The entire GIFWARP! package, including the GIFWARP! program,
  59.      documentation, and sample files are Copyright 1990, Steve   
  60.      Enns and Dan Magosse.  All rights reserved.  The
  61.      unregistered shareware version of the GIFWARP! may be freely
  62.      distributed to others by any means, as long the following
  63.      (three) conditions are met:
  64.  
  65.           1) GIFWARP! is distributed in a "package" containing
  66.           the following three files:
  67.                               GIFWARP.EXE
  68.                               GIFWARP.DOC
  69.                               GW-READ.ME
  70.           
  71.           2) GIFWARP! is not distributed as part of any other    
  72.           product, except with specific written permission from
  73.           the authors.
  74.  
  75.           3) NO fee of any kind is charged for the GIFWARP!
  76.           package or for the service of providing the package,
  77.           except Computer Bulletin Board Systems, which may
  78.           distribute the GIFWARP! package even though they may
  79.           charge a membership or service fee.
  80.  
  81.      You can use the "shareware" version for as long as you want,
  82.      even until you're well into your nineties, but you are of
  83.      course encouraged to send us lots of money, too. (I'm
  84.      struggling to pay for my violin lessons, and Dan needs a new
  85.      fishing rod.)  On the other hand, a "registered" version of
  86.      GIFWARP! is available from the authors for $8.00 U.S.  The
  87.      registered version provides support for 512K SuperVGA cards
  88.      from most manufacturers (see REQUIREMENTS below).  The
  89.      registered version is licensed to  the purchaser
  90.      exclusively, and may not be distributed to others.  To      
  91.      order the SuperVGA version of GIFWARP!, send $8.00 U.S.     
  92.      to the "Steve Enns" guy mentioned above.  You will receive a
  93.      5.25" (sorry NO 3.5" disks!) disk with the latest SuperVGA
  94.      version of GIFWARP!
  95.  
  96. REQUIREMENTS
  97.  
  98.           GIFWARP! requires the following:
  99.  
  100.                -    A strange desire to warp GIF(tm) pictures
  101.                -    PC(tm)/XT(tm)/AT(tm)/386 computer-like thing
  102.                -    About 280K of free RAM
  103.                -    DOS 3.0 or up (recommended - others untested)
  104.                -    A mouse that at least claims to be
  105.                          compatible with something
  106.                -    A VGA or SuperVGA card
  107.                -    Some GIF(tm) pictures to warp!
  108.  
  109.           and optionally:
  110.  
  111.                -    Really artsy attitude with a preference for
  112.                          Dali or Cubist Picasso
  113.                -    Those chips that do that strange math stuff
  114.                          (8087/80287 or 80387 Especially helpful
  115.                          for big, high res transformations)
  116.                -    SuperVGA - The registered SuperVGA version of
  117.                     GIFWARP! supports modes like 640x480, 800x600
  118.                     with 256 colours on 512K SuperVGA cards from
  119.                     ATI, Ahead, Cirrus, Chips and Technologies,
  120.                     Everex, OAK, Paradise, Trident, Tseng and
  121.                     Video7.  See the LICENSE section above for
  122.                     ordering information.
  123.  
  124. INSTALLATION
  125.  
  126.      Copy the GIFWARP! program (and this helpful document of
  127.      course!) to any directory that you want - perhaps with      
  128.      your favourite GIF(tm) viewer somewhere in the DOS          
  129.      path.
  130.  
  131. USAGE
  132.  
  133.      Syntax for GIFWARP! is as follows:
  134.  
  135.           GIFWARP [?] infilename[.GIF] [outfilename[.GIF]]
  136.  
  137.      or
  138.  
  139.           GIFWARP [?] infilename[.GIF] [outfilename[.GIF]]
  140.                          [/mode={0,1,2,3}]
  141.  
  142.      for the registered version.  ( The /mode=n parameters are as
  143.      follows:       /mode=0        Ordinary 320x200 mode
  144.                     /mode=1        Low resolution SVGA
  145.                                         640x400 or 640x350
  146.                                         depending on your card.
  147.                     /mode=2        Medium resolution 640x480
  148.                     /mode=3        High resolution 800x600 
  149.  
  150.                {    /mode=4        Higher resolution 1024x768
  151.                                         Coming soon? }      )
  152.                                                        
  153.      For example, try:
  154.  
  155.           C> GIFWARP               to see the title screen
  156.  
  157.           C> GIFWARP ?             to see the help/brag screen
  158.  
  159.           C> GIFWARP house         to view/warp the file
  160.                                    HOUSE.GIF writing the warped
  161.                                    picture (if any) to the 
  162.                                    default name GIFWARP.GIF
  163.  
  164.           C> GIFWARP house house2  view/warp the file HOUSE.GIF,
  165.                                    writing output to HOUSE2.GIF
  166.  
  167.      With the registered version:
  168.  
  169.           C> GIFWARP car /mode=2   View/warp CAR.GIF using medium
  170.                                    resolution SuperVGA
  171.                               
  172. TUTORIAL
  173.  
  174.      (Just play around with GIFWARP! for a while - you'll get the
  175.      hang of it very quickly...)
  176.  
  177.      Try out the following with your favourite GIF(tm) picture:
  178.  
  179.                C> GIFWARP picturename
  180.  
  181.      GIFWARP! will load the picture and display it one your
  182.      screen.  A rectangle will appear in the centre of the
  183.      picture.  The rectangle is divided into four smaller
  184.      rectangles, and the entire rectangle will move with the
  185.      mouse.  This "target box" allows you to choose areas of the
  186.      picture that you want to warp.  You can change the size of  
  187.      the target box using the arrow keys or number pad.
  188.  
  189.           Choose an area of the picture, and move the target     
  190.      box to that area.  Change the size of the box if you want. 
  191.      Now, press the left mouse button.  After pressing the left
  192.      mouse button, when you move the mouse the target box will no
  193.      longer move, but you will now be changing the shape of the
  194.      four smaller rectangles that make up the target box.  (If
  195.      you want to move the target box to a different area of the
  196.      picture, just press the left mouse button again - you can
  197.      then move the target box again.)  Position the mouse to     
  198.      choose a new shape of the smaller rectangles, and then press
  199.      the right mouse button.
  200.  
  201.           The picture will now be warped according to the new
  202.      shape of the smaller rectangles.  This process may be
  203.      repeated as often as desired.  Just remember that the left
  204.      mouse button is used to select the area to be warped, and
  205.      the shape of the warp, the right mouse button is used to do
  206.      the warp.
  207.      
  208.           After you have warped the picture, press the <ENTER> or
  209.      <RETURN> key to save the warped picture onto disk.  The
  210.      picture will be saved with the name GIFWARP.GIF, or the     
  211.      output name that you specified when you started GIFWARP!. 
  212.      If you don't want to save the picture, then just press the
  213.      <ESC> key, and GIFWARP! will exit without saving the current
  214.      picture.
  215.  
  216.  
  217.  
  218. HINTS
  219.  
  220.      - Try subtle as opposed to drastic choices when choosing a
  221.      warp.  Subtle changes will usually look more "realistic,"
  222.      although dramatic changes may also produce interesting
  223.      effects.
  224.  
  225.      - GIF(tm) pictures of faces and animals can be warped to
  226.      produce a variety of interesting effects.  You can do really
  227.      strange things to faces - pinnochio noses and stuff like
  228.      that.  Warps of ordinary pictures like cars, scenery or
  229.      houses can also produce truly bizarre and surreal effects. 
  230.      Upload your best warped GIFs to a local Bulletin Board
  231.      System, or from wherever you got GIFWARP! 
  232.  
  233.      - Some degradation in picture quality is always produced by
  234.      the warping process.  These artifacts can be minimized by
  235.      careful choice of warps, and by not "re-warping" the same
  236.      area over and over again, as the quality will be reduced
  237.      each time the area is processed.  If the warped picture has
  238.      been really messed up, then just hit <ESC>, and start again. 
  239.      (The best solution, is of course to purchase the registered
  240.      SuperVGA version for a measly $8.00 U.S.  The resolution of
  241.      the SuperVGA modes allows for the most  "realistic" and     
  242.      highest quality transformations.)
  243.  
  244. ERRORS
  245.  
  246.      - The following self explanatory error messages may be
  247.      produced by GIFWARP!  The errors involving the GIF(tm) files
  248.      will generally be due to disk errors or faulty image files. 
  249.      Other errors refer to lack of enough free RAM space, or lack
  250.      of required hardware (VGA and Mouse).
  251.  
  252.           Can't initialize VGA graphics!
  253.           Mouse driver not installed.
  254.           Can't allocate mouse memory!
  255.           Unexpected EOF reading GIF!
  256.           Premature end of GIF!
  257.           Not GIF file!
  258.           Invalid GIF format
  259.           Error writing GIF!
  260.           Buffer allocation failure!
  261.           
  262. NOTES
  263.  
  264.      - Look for example images warped by GIFWARP! on your
  265.      favourite Bulletin Board System.  Examples from us will
  266.      probably be named  nGIFWARP.GIF  where "n" is a number or
  267.      letter.   
  268.  
  269.      - GIFWARP! reads both GIF87A standard (the original) and    
  270.      new GIF89A pictures, although most of the extensions in the
  271.      new GIF89A standard like (silly) text windows are ignored. 
  272.      The last image in multi-image GIFs will be the one displayed
  273.      for warping in GIFWARP!
  274.  
  275.      - Although only the registered copy of GIFWARP! provides
  276.      full SuperVGA resolution, all GIF pictures can be decoded
  277.      and displayed on all versions of GIFWARP!  If the image is
  278.      too large for the available resolution, the image will be
  279.      centred on the screen.  You will see the middle 320x200
  280.      pixels of the image when the entire image is larger than
  281.      320x200, for example.  The registered version of GIFWARP!
  282.      will display images at resolutions up to 800x600 according
  283.      to the size of the picture, or the specified mode.  (When
  284.      specifying a mode with a resolution higher than the image,
  285.      an image will be displayed at the resolution of the screen,
  286.      which allows high resolution warping to be done on lower
  287.      resolution images.)
  288.  
  289. HISTORY
  290.  
  291.      - Version 1.0 Completed Nov.1 1990
  292.  
  293. PROPOSED FUTURE ENHANCHMENTS
  294.  
  295.      These enhancments might be encorporated into GIFWARP! at
  296.      some point in the future. (Especially if I lose my job, and
  297.      have lots of free time.)
  298.  
  299.      - "Undo feature" - remove effect of last warp operation.
  300.  
  301.      - Support for other graphics hardware.  Hopefully, we will
  302.      be able to support new hardware and graphics modes as they
  303.      are introduced.
  304.  
  305.      - Support for other file formats?
  306.  
  307.      - Faster GIF(tm) decoding and encoding
  308.  
  309.      - Faster mapping.
  310.  
  311.